Updating the Mule ESB Logging Agent

Stay ahead with the latest features, security, and performance improvements by updating your Nodinite Mule ESB Logging Agent. This guide empowers you to upgrade smoothly, avoid pitfalls, and maximize the value of your integration monitoring.

Release notes

For detailed information about new features, fixes, and improvements, visit the release notes for the Mule ESB Logging Agent.

Running Version

You can check your installed version in the 'Version' text box:

Version information in the agent's UI

Alternatively, view the file details property on the local installation:

File version property in Windows

PreReq: Before updating, ensure you have already installed the Mule ESB Logging Agent. The service account must have Logon as Service Right. See prerequisites for Mule ESB Logging Agent for more details.

Note
You must be a local administrator to install or update Windows Services.

Compatibility and versioning issues

Upgrading from 4.X to 5.X? Review Updating from V4 to V5 for important compatibility notes.

Update guide

Follow these steps to update your Mule ESB Logging Agent.

Step 1: Start the installer

Double-click the MSI file to launch the update process for the Nodinite Mule ESB Logging Agent.

Start the update with the MSI installer

Step 2: Welcome Screen

After launching the MSI, you'll see the Welcome screen:

Welcome screen of the installer

Click 'Next' to continue or 'Cancel' to exit the installer.

Step 3: Custom Setup

Select the features and location to update.

Custom setup options for the update

Default settings are recommended for most users.

Note
If you change the location, your old configuration will be lost.

Click 'Next' to continue or 'Cancel' to exit.

Step 4: Service Account Information

Enter the credentials for the Account that will run the Nodinite Mule ESB Logging Agent.

Domain: The domain name the server belongs to. For a local account, use the server name or a dot (.) as the domain.
User: The account username.
Password: The account password.

Service account credentials screen

Note
The account must have 'Log on as Service Right'.

Click 'Next' to continue or 'Cancel' to exit.

Insufficient Privileges

If the account information does not meet the Prerequisites, you will see an error message:

Error message for insufficient privileges

Common reasons for this error:

The account is not allowed to run as a service
The account is not a local Administrator on the server

Follow the guide How to set Logon as a Service right and click Retry. If the problem persists, click Cancel and restart the installer. Ensure you enter valid credentials!

Tip
Check the local event log (System and Application) for additional error details.

Step 5: Completed setup

The final step will indicate either a successful update or a premature exit.

Successful update example

Click Finish to exit the installer.

When the setup finishes, your default text editor will open a file named 'README.txt'. This file contains essential information for setting up and managing the agent as a Monitoring Agents for Nodinite.

README.txt file with post-update instructions